Downloading the Debug (and Core Dump) File

You can download the debug file from the device (flash memory) and save it to a folder on your local computer.

The device creates the debug file whenever an exception occurs. Each time the device creates a new debug file, it overwrites the existing file. The debug file is saved as a TAR (Tape ARchive) file (.tar), with the following filename format: debug_<Device Name>_ver_<Firmware Version>_mac_<MAC Address>_<Date>_<Time>. For example, debug_SBC_ver_740-500-966_mac_5b-10-35_13-3-2024_10-52-37.tar.

The debug file contains the following:

■

Exception information, indicating the specific point in the code where the crash occurred and a list of up to 50 of the most recent SNMP alarms that were raised by the device before it crashed.

■

Restart (reset) history, where each restart entry provides the reason of the restart (e.g., triggered by Web interface or was an exception), date and time the restart occurred, and software version of the device. This information appears in the reset-history folder.

■

Latest syslog messages that were recorded prior to the crash.

■

Core dump file if all of the following conditions are met:

●

You have enabled core dump generation (see Enabling Core Dump File Generation).

●

You have not configured an IP address to send the core dump to a remote server (see Enabling Core Dump File Generation).

●

The device has sufficient memory on its flash memory.

●

You have enabled the inclusion of the core dump file in the debug file (see below procedure).

■

Information on the Floating and Metering licenses (FloatLicense.lzma and MeterLicense.lzma files, respectively, in the system_logs folder).

■

If the device is configured with a Client Defaults ini file, it's included in the debug file in the Device folder (default.ini).

■

Configuration Package file (in the Device folder).

■

The debug file may include additional application-proprietary debug information.

➢

To download debug file:

1.

Open the Debug Files page (Troubleshoot menu > Troubleshoot tab > Debug folder > Debug Files), and then scroll down to the 'Save The Debug File To The PC' group:

2.

By default, the core dump file is included in the downloaded debug file. If you don't want to include it, clear the 'Attach Core Dump File' check box.

3.

Click the Save Debug File button; the device downloads the debug file to a folder on your computer.